Customize supported ID documents
Customize settings for countries and documents.
Take full control of your verification process by customizing the Dashboard's acceptance settings for specific countries and documents.
Specify documents for all countries
To specify ID documents for all countries:
- In the Dashboard, go to the Supported ID Documents page.
- In the table header, select the relevant checkboxes to include the documents to the list of supported.
The changes are saved automatically.
Specify documents for selected countries
To specify ID documents for particular countries:
- In the Dashboard, go to the Supported ID Documents page.
- Expand a continent with the countries for which you want to customize data extraction.
- In the column of the relevant document, click the selector switch and select an option:
- Off — document is not allowed.
- One Side — document is supported; the front side is required.
- Two Sides — document is supported; both front and back sides are required.
- Any Sides — document is supported; any side of the document can be provided. This option is available only if any side of country documents contains required data.
The changes are saved automatically.
Customize extraction process
To customize data extraction process:
- In the Dashboard, go to the Supported ID Documents page or ID document settings in specific Verification Levels.
- Expand a continent with the countries for which you want to customize data extraction.
- Hover the cursor over the country you need and click the pencil icon on the right to open the Fields management window.
- In the Document field, select the document to be changed.
- If Sumsub supports digital version of the selected document type, you will see the Allow digital versions of documents checkbox. Select it, if you want to enable this setting. Note that digital documents generally lack physical security features, which makes them easier to forge compared to physical documents.
- Select the Accept document screenshots for POI checkbox if you want to disable screenshot protection. If selected, we will accept screenshots of identity documents for which you have applied this setting.
- Uncheck the Details ought to be blurred checkbox if you have a legal obligation or permission to operate with non-blurred documents of the selected type. By default, we blur document data for the following countries: Japan (only My Number Card is blurred), Netherlands, South Korea, and Singapore so that the personal data is protected upon initial recognition. Note that masking already applied cannot be reverted, meaning that, when a document image is partially blurred, it cannot be restored to its original condition. If you uncheck this setting, data extraction will be enabled for new applicants only.
- Select expiration check mode:
- Strict — accepts only valid documents. Any regulations extending the validity period of a document will not be taken into account.
- Generally Accepted Regulations — accepts expired documents if their validity period was extended by a government regulation or decree, for example, documents extended because of COVID.
- Local Regulations — accepts expired documents if their usage is allowed by local regulations. For example, in Brazil, it is allowed to accept expired driving licenses as proof of identity.
- Allow expired — accepts expired documents.
- In the Mode block, select OCR mode, where the Default option stands for accepting all official documents, while MRZ document determines accepting only those that include MRZ.
- Choose preferred characters for recognition.
- Configure the forbidden document subtypes that contain human-readable names. Note that these names are only available in English. Document subtypes are also displayed on the applicant page, making it easier to understand which document was submitted.
- Select the default fields in documents to be recognized and add extra fields for recognition. Mind that you cannot select or deselect mandatory fields.
- Click Apply to save your changes.
Data extraction customization is available at an additional cost. Contact our sales team or reach out to your Customer Success Manager for more information.
Adjust ID document subtypes
Our system displays document types on the Identity document verification step. Many identity document types have country-specific subtypes, which are detected automatically during verification based on the recognized document.
For certain document subtypes, we group similar documents under a single, user-friendly name. This helps applicants better understand which document they are expected to upload and simplifies the document selection process in the WebSDK interface.
Click here to expand a list of grouped document subtypes by country. Each group shows the document type, technical subtype codes, and the display name shown to applicants.
Country |
Document type |
Subtype display name |
Subtype code |
|---|---|---|---|
Argentina (ARG) |
Passport |
Passport |
|
ID |
National Identity Document (DNI) |
|
|
Driving License |
Driver's license |
|
|
Brazil (BRA) |
ID |
ID Card (RG) |
|
Professional Identity Card |
|
||
India (IND) |
ID |
Aadhaar card |
|
PAN Card |
|
||
Voter card |
|
||
Mexico (MEX) |
Passport |
Passport |
|
ID |
Voter ID / INE ID Card |
|
|
Residence Permit |
Residence permit |
|
|
Myanmar (MMR) |
Passport |
Passport |
|
Certificate of Identity |
|
||
ID |
Overseas Worker Identification Card (OWIC card) |
|
|
National Identity Card |
|
||
Pakistan (PAK) |
Passport |
Passport |
|
ID |
Identity Card (CNIC) |
|
|
National Identity Card Overseas Pakistanis (NICOP) |
|
||
Driving License |
Driving license |
|
|
Philippines (PHL) |
Passport |
Passport |
phl.passport.type2 |
ID |
PhilID / National ID |
|
|
Unified Multi-Purpose ID (UMID) |
|
||
TIN ID |
|
||
Postal ID |
|
||
Social Security Card / SSS ID |
|
||
Voter’s ID |
|
||
PhilHealth ID |
|
||
South Africa (ZAF) |
Passport |
Passport |
|
ID |
Identity Card |
|
|
Green ID booklet |
|
||
Driving License |
Driving licence |
|
|
South Korea (KOR) |
Passport |
Passport |
|
ID |
Identity Card / Resident Registration Card |
|
|
Driving License |
Driver’s license |
|
|
Residence Permit |
Residence Card / Alien Registration Card |
|
|
|
Ukraine (UKR) |
Passport |
Internal Passport |
|
International Passport |
|
||
Driving License |
Driving licence |
|
|
Residence Permit |
Residence permit |
|
Hide document subtypes in WebSDK UI
Set up a configuration to hide the list of document subtypes in the WebSDK interface:
- Adjust the settings for a specific verification level or apply them across the entire system:
- Go to Integrations→Global settings, navigate to the User verification tab, and open Supported ID Documents.
- Go to the verification level settings and navigate to the Configurations tab→ID document settings.
- Locate the required country and go to the Field management settings.
- Select the document type and navigate to the settings under the Subtypes section.
- Select the required option and check the Do not show subtypes in WebSDK box.
Note
Once the settings are applied, only the main document type will be displayed in the interface. However, all document subtypes will still be accepted and processed according to the configuration.
Customize document subtype names
Adjust how document subtype names are displayed to applicants in the WebSDK interface using SDK Translations.
To edit subtype names:
- Go to Integrations and navigate to SDK Translations.
- Select the required translation file and open the WebSDK 2 tab.
- Locate the parent translation key
customSubtypes. - Edit subtype names and save the changes.
For document types that do not have subtype grouping from the list above, edit the translations under WebSDK 2 → documentTypes.
Important
When updating translations, make sure to apply the changes to all languages used in the WebSDK.
Manage extra document fields for OCR
Specify extra document fields that must be scanned by OCR and then transferred as textual information to the applicant profile:
- In the Dashboard, go to the Supported ID Documents page.
- Select the countries for which you want to manage the document fields and click Manage documents.
- Select the documents to be changed and choose the preferred recognition characters.
- Set up the manner of changing the field recognition:
- Select Fields to show to scan the selected fields.
- Select Fields to hide to disable the selected fields from OCR.
- From the Extra fields list, select the fields you want to manage. Unmarked fields will not be changed.
- Click Apply to save the changes.
Updated 7 days ago